home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / smast300.arc / SMASTER.DOC < prev    next >
Text File  |  1991-07-26  |  30KB  |  833 lines

  1.  
  2.        ▄▄▄▄▄▄▄▄▄▄▄
  3.        █  ▄▄▄▄▄  █
  4.        █  █   █▄▄█ ▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄
  5.        █  █▄▄▄▄▄▄▄ █ ▄▄▄ ▄▄▄ █ █ ▄▄▄▄ █ █ ▄▄▄▄█ █▄▄ ▄▄█ █ ▄▄▄▄█ █ ▄▄▄▄ █
  6.        █▄▄▄▄▄▄▄  █ █ █ █ █ █ █ █ █▄▄█ █ █ █▄▄▄▄   █ █   █ █▄▄   █ █▄▄█ █
  7.        ▄▄▄▄   █  █ █ █ █▄█ █ █ █ ▄▄▄▄ █ █▄▄▄▄ █   █ █   █ ▄▄█   █ ▄▄▄ ▄█
  8.        █  █▄▄▄█  █ █ █     █ █ █ █  █ █ ▄▄▄▄█ █   █ █   █ █▄▄▄▄ █ █ █ █▄
  9.        █▄▄▄▄▄▄▄▄▄█ █▄█     █▄█ █▄█  █▄█ █▄▄▄▄▄█   █▄█   █▄▄▄▄▄█ █▄█ █▄▄█
  10.  
  11.  
  12.                          V E R S I O N   3 . 0 0
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                          "Deluxe Files Lister"
  19.  
  20.                   Written by Yossi Gottlieb, 1990-91.
  21.  
  22.                           ALL RIGHTS RESERVED.
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.         ┌──────────────────────────────────────────────────────────────┐
  40.         │░░░ DISCLAIMER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  41.         └──────────────────────────────────────────────────────────────┘
  42.  
  43.  
  44.  
  45.  
  46.  
  47.        SMaster is  being distributed on  the Shareware basis.  It may be
  48.        freely distributed in any media, as long as a few terms are kept:
  49.  
  50.       - All files included in original package, including both XT and AT
  51.         executables,  additional  files   and  documentation  files  are
  52.         distributed, in  their original unmodified  form. If you  modify
  53.         any of the  files (for any reason), do not  distribute them as a
  54.         part of the SMaster 3.00 Package.
  55.  
  56.       - You must  charge no money for  the program. A minimal  amount of
  57.         money  may be  charged for  the floppy  (or for  other media you
  58.         distribute SMaster).
  59.  
  60.  
  61.         Also, please note  that SMaster was tested for  more than a year
  62.         in several locations, and on many different configurations.
  63.  
  64.         SMaster  3.00  itself  was  tested  in  ten  beta-versions,  and
  65.         performs very well.
  66.  
  67.         Another  thing you  have to  know before  using SMaster  is that
  68.         you're the  only one who can  be held responsible for  damage or
  69.         loss caused  directly or indirectly by  SMaster. Although it has
  70.         no destructive  operation, nor sensitive or  critical code, I do
  71.         not know under what environment  SMaster will work, and who will
  72.         take care of it.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.         ┌──────────────────────────────────────────────────────────────┐
  84.         │░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 1.0 ░░│
  85.         └──────────────────────────────────────────────────────────────┘
  86.  
  87.  
  88.  
  89.  
  90.  
  91.         Unlike the name (Bulletin Board  System, BBS), most of the BBSes
  92.         today  are running  around files.  The best  BBS has  the newest
  93.         files,  or the  biggest files  library, or  the biggest  area of
  94.         files  for a  specific subject.  This is  why listing files, and
  95.         choosing the files to be downloaded  is that hard. A very common
  96.         file is a text file (or a compressed text file), which holds the
  97.         list of  all the system's  files. Another, less  common file, is
  98.         the file with all new files on the board.
  99.  
  100.         In order to create these files, all you need is one of dozens of
  101.         programs available for  this kind of job. The  way to select the
  102.         program to use is easy. You're  looking for a program which will
  103.         work  on your  BBS program,  fast, with  the smallest  number of
  104.         crippled options (if author requires registration), and the look
  105.         of the ready list.
  106.  
  107.         SMaster is "one of these files",  plus a lot of features. a list
  108.         of all SMaster's  features is included below. If  you don't know
  109.         yet whether you will use it or not, browse in the list, and make
  110.         up your mind.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.         ┌──────────────────────────────────────────────────────────────┐
  122.         │░░░ FEATURES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 1.1 ░░│
  123.         └──────────────────────────────────────────────────────────────┘
  124.  
  125.  
  126.  
  127.  
  128.  
  129.         ∙■∙ Support for a wide range of BBS software, and BBS enhancers.
  130.             QuickBBS, RemoteAccess  and SuperBBS are  fully supported. A
  131.             very good  utility for "filling gaps"  in the above programs
  132.             is the QFV package, which is (obviously) supported.
  133.  
  134.         ∙■∙ SMaster   is  capable  of  creating  All-Files  list  (which
  135.             contains files  from all  BBS areas),  New-Files list (which
  136.             contains only files which were added in the last days -  you
  137.             select  how  many  days  exactly).  Two  other  lists can be
  138.             created,  which  are  mainly for file-base  maintenance. The
  139.             Missing-Files  list,  which  is  a  list  of all files which
  140.             cannot be found on the  disk (but listed on FILES.BBS),  and
  141.             Orphans-list, which is a list contains files found on  area,
  142.             but not listed in FILES.BBS.
  143.  
  144.         ∙■∙ Sophisticated  selection  of  areas  to process.  Instead of
  145.             working on  ALL file-areas  when creating  any of  the above
  146.             lists, SMaster can process only selected areas. Since  every
  147.             area has a security level, the selection is done by defining
  148.             a security range,  and only areas which belong to that range
  149.             are processed.
  150.  
  151.         ∙■∙ Addition of  text files as  banners on top  of the all-files
  152.             and new-files list (may be a separate banner for each list).
  153.  
  154.         ∙■∙ Optional  addition  of  statistical information  about every
  155.             area  BEFORE  the  area  itself, and statistical information
  156.             about  all  the  listed  areas  together  at  end  (both are
  157.             optional).
  158.  
  159.         ∙■∙ Easy set-up process (using windowed, menued program).
  160.  
  161.         ∙■∙ Sophisticated  word-wrapping  routines.  These  routines  DO
  162.             support the SuperBBS and QFF extended description lines.
  163.  
  164.         ∙■∙ Multi-Line  BBSs  compatibility:   Screen-writes  are  fully
  165.             DESQview  aware   (and  still   lightning-fast).  The   main
  166.             executable also SHARE  files (Uses File-Sharing  routines to
  167.             prevent accidental  corruption of  files when  several tasks
  168.             access the same file).
  169.  
  170.         ∙■∙ The main executable (SMASTER) comes in two versions: One  is
  171.             for 8088/8086 (XT) machines, and one is built to work  under
  172.             80286   (AT)  or better.  The 286  version  will work on 286
  173.             or better machines only and is smaller and faster.
  174.  
  175.         ∙■∙ Compatibility  with  both  text-file  areas-definition  file
  176.             (FLSEARCH.CTL  -  QuickBBS),  and  the binary RemoteAccess's
  177.             file (FILES.RA).
  178.  
  179.         ∙■∙ Sort  option  to  sort  the  all-files  list  (only).  Fully
  180.             supports long-lines  (QFF/SBBS). Sort  is done  in ascending
  181.             order, using the file's name as an sort-element.
  182.  
  183.         ∙■∙ Download-counters  handling (Stripping,  Forcing, Ignoring).
  184.             The change will be seen in  the lists only, and will not  be
  185.             written to the FILES.BBS itself.
  186.  
  187.         ∙■∙ ANSI  Colors  sequences  may  be  added in list,  to make it
  188.             colorful. The colors to use can be set by the SysOp.
  189.  
  190.         ∙■∙ Creation  of Ready-To-Print  lists: All-Files  and New-Files
  191.             lists may be cut to  pages (in a desired size),  and headers
  192.             may be put on top of every page.
  193.  
  194.         ∙■∙ Creation of several lists, in different profiles, using more
  195.             than one configuration files (discussed later).
  196.  
  197.         ∙■∙ Ofsetting of the extended description lines, for making  the
  198.             list looking better in case download-counters are displayed.
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.         ┌──────────────────────────────────────────────────────────────┐
  210.         │░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.0 ░░│
  211.         └──────────────────────────────────────────────────────────────┘
  212.  
  213.  
  214.  
  215.  
  216.  
  217.         The installation  process is quite  short and easy,  but if done
  218.         wrong might cause some unwanted results.
  219.  
  220.         First, copy all  files which were in SMaster's  package into the
  221.         directory  there it  will run   from. You  may assign  a special
  222.         directory for SMaster, but it is not required.
  223.  
  224.         If you're using  a XT machine (8088 or  8086 based machine), you
  225.         should use the SMASTER.EXE file only. 80286/80386/80486 machines
  226.         would rather like to use the  SMASTER2.EXE, which is the same as
  227.         SMASTER.EXE,  but makes  use of  the special  AT (286 or better)
  228.         features, saving time and size.
  229.  
  230.         The  next step  in the   installation procedure  is to  create a
  231.         config   file.  In   this   section   we  will   discuss  normal
  232.         installation.  Installation  with   several  config  files,  and
  233.         updating from earlier versions will be discussed later.
  234.  
  235.         The configuration file is built and changed using the SMCFG.EXE,
  236.         supplied with SMaster. Run this file.
  237.  
  238.         On the screen,  on the left side, you have  a panel for choosing
  239.         fields to  be changed, and  on the right  side a panel  with the
  240.         current  settings.  When  choosing  a  field  to change, general
  241.         description about it will be  displayed. Some options will cause
  242.         a secondary  menu to appear,  instead of directly  prompting for
  243.         new value.  You will have  to select the  exact topic you  would
  244.         like to change  (i.e. For changing the all-files  list name, you
  245.         should  choose from  main menu  the "MasterList",  then from the
  246.         sub-menu "MasterList Name").
  247.  
  248.         A detailed explanation about every field is included below.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.         ┌──────────────────────────────────────────────────────────────┐
  260.         │░░░ SMCFG FIELDS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.1 ░░│
  261.         └──────────────────────────────────────────────────────────────┘
  262.  
  263.  
  264.  
  265.  
  266.  
  267.        - Minimum Security
  268.  
  269.        This parameter specifies the minimum security level which an area
  270.        should be  set to, in order  to be processed by  SMaster. Usually
  271.        set this to 0.
  272.  
  273.  
  274.  
  275.        - Maximum Security
  276.  
  277.        This parameter specifies the maximum security level which an area
  278.        should be set to, in order to be processed by SMaster. Using this
  279.        parameters, you can cause some specific areas to be excluded from
  280.        all lists (Set  their security level to higher  than the "Maximum
  281.        Security" field).
  282.  
  283.  
  284.  
  285.  
  286.        - MasterList Name
  287.  
  288.        This parameter is  the name (may be, and  strongly recommended, a
  289.        full path-name) of the all-files list. You can create it directly
  290.        inside one of  your file areas, and disable the  need to move the
  291.        file into the file-base after it is done.
  292.  
  293.  
  294.  
  295.  
  296.        - MasterList Banner
  297.  
  298.        The name  (may include full-path)  of the text  file to put  as a
  299.        banner on top of the all-files list. If none is wanted, keep this
  300.        field empty.
  301.  
  302.  
  303.  
  304.  
  305.        - Extended Offset
  306.  
  307.        When using download-counters at the beginning of the description,
  308.        you may want to put all extended description (beginning with line
  309.        2) in  an offset, instead  of under the  download-counter. If you
  310.        do, enter the number of characters offset. 0 specifies no offset.
  311.  
  312.  
  313.  
  314.        - NewList Name
  315.  
  316.        This parameter is  the name (may be, and  strongly recommended, a
  317.        full path-name) of the new-files list. You can create it directly
  318.        inside one of  your file areas, and disable the  need to move the
  319.        file into the file-base after it is done.
  320.  
  321.  
  322.  
  323.  
  324.        - NewList Days
  325.  
  326.        The number  of days to  list back in  new-files list. If  SMaster
  327.        finds files  which have a date  "in the future", it  will include
  328.        them too (since  many SysOps mark some files  with a future date,
  329.        so the file will be listed as "new file" for many days).
  330.  
  331.  
  332.  
  333.  
  334.        - NewList Banner
  335.  
  336.        The name  (may include full-path)  of the text  file to put  as a
  337.        banner on top of the new-files list. If none is wanted, keep this
  338.        field empty.
  339.  
  340.  
  341.  
  342.  
  343.        - Toggle Statistics
  344.  
  345.        Toggles the global (full  list) statistical information. When ON,
  346.        file-base statistics will be added on the bottom of the new-files
  347.        and all-files list.
  348.  
  349.  
  350.  
  351.  
  352.        - Sort MasterList
  353.  
  354.        Toggles the sort for the all-files  list. The sort element is the
  355.        file-names, and  in ascending direction.  When sorting, no  extra
  356.        memory is needed (actually additional 32Kb is needed, but SMaster
  357.        allocates  it  anyway),  since  2  disk  files  are being used as
  358.        virtual memory.
  359.  
  360.  
  361.  
  362.  
  363.        - DownLoad Counter
  364.  
  365.        You can command SMaster to handle download counters in any one of
  366.        the following manners (The change will be seen in the list itself
  367.        only, the FILES.BBS will not be changed):
  368.  
  369.        No Change  --  SMaster won't touch the download-counters.
  370.  
  371.        Force      --  SMaster will add them if they are missing.
  372.  
  373.        Strip      --  SMaster will strip any download counter.
  374.  
  375.  
  376.  
  377.  
  378.        - ANSI Colors
  379.  
  380.        Toggles the  usage of ANSI Color  sequences in the lists.  If you
  381.        set it to ON, you will have  to select what color will be used in
  382.        every  part  of   the  list  (Default  ones  are   set  for  best
  383.        convenience).  ANSI  sequences  will   enlarge  your  lists,  but
  384.        compression programs (such as PKZIP,  LHa, ARJ) can compress ANSI
  385.        with great success.
  386.  
  387.  
  388.  
  389.  
  390.        - Area Status
  391.  
  392.        This option, when selected, will add  a built-in banner on top of
  393.        every area in  the lists, and will write  the amount of available
  394.        (not OFFLINE) files  in the area, the total  size (in KB/MB), and
  395.        the  average  size  of  file.  Area-Name  will  also  be included
  396.        (double-spaced, capitalized).
  397.  
  398.  
  399.  
  400.  
  401.        - No Description Text
  402.  
  403.        Sometime, for any reason, no  description is available for a file
  404.        (in FILES.BBS  the file appears,  but with no  description). Some
  405.        people don't  like those gaps in  the list, and prefer  that "Not
  406.        yet  commented"  or  any  other   text  will  replace  the  blank
  407.        description. If you are in this  club, put in that field the text
  408.        you wish  to put if  no description is  available. If you  do not
  409.        want such thing to appear, keep this field empty.
  410.  
  411.  
  412.  
  413.  
  414.        - MissingFiles
  415.  
  416.        This is the name of an optional  file which will have the list of
  417.        all missing files  on the BBS. Missing files  are the files which
  418.        are listed in FILES.BBS, but does  not exist on the DOS directory
  419.        (often called  OFFLINE files). Empty  name will indicate  no file
  420.        should  be created.  If you  specify a  name for the MissingFiles
  421.        list, and there are no missing  files on your board (lucky you!),
  422.        no such list will be created.
  423.  
  424.  
  425.  
  426.  
  427.        - Page Size
  428.  
  429.        The length (in lines) of a  printer page, in case the list should
  430.        be cut  to pages for  better print-out. If  no control characters
  431.        should be used, set this parameter to 0.
  432.  
  433.  
  434.  
  435.  
  436.        - Header
  437.  
  438.        If  printer  control  characters  are  used  (i.e.  Page  Size is
  439.        different than 0), SMaster can put  on top of each printed page a
  440.        header.  If you  wish such  header to  be added,  edit it in that
  441.        field. If none  should be used - keep the  field empty. Note that
  442.        the header  length is not  a full 80  characters length, but  the
  443.        line will be centered.
  444.  
  445.  
  446.  
  447.  
  448.        - Area-Def. Type
  449.  
  450.        SMaster can  read two types  of area definition  files: Text-File
  451.        (FLSEARCH.CTL), or binary (FILES.RA). Choose the type you wish to
  452.        use. T stands for TEXT, B stands for Binary.
  453.  
  454.  
  455.  
  456.  
  457.        - Area-Def FileName
  458.  
  459.        You must specify the exact name (and path) of the area-definition
  460.        file. Do it in this field.
  461.  
  462.  
  463.  
  464.  
  465.        - Orphans List
  466.  
  467.        This  option allows  you to   create an  orphans list.  This list
  468.        contains  the files  (in all  areas), which  exist on  the area's
  469.        path, but not mentioned in the FILES.BBS. If you do not want such
  470.        list  to be  created, keep   this field  blank. SMaster  will NOT
  471.        accept  the following  files as  orphans: FILES.BBS, SMASTER.TMP,
  472.        FILES.BAK,   PFILES.BBS,  [All-Files   Name],  [New-Files  Name],
  473.        [Missing-Files  Name],  [Orphans-Name],  4DOSSWAP.*,  NDOSSWAP.*,
  474.        DESCRIPT.ION and all the independent files (read next paragraph).
  475.  
  476.  
  477.  
  478.  
  479.        - Independent Files
  480.  
  481.        When creating orphans list, you might  want SMaster to have a few
  482.        file names which will never be displayed as orphans, even if they
  483.        are not listed in the FILES.BBS (i.e. independent files). You may
  484.        specify  here  up  to  20  independent  files.  You  may  NOT use
  485.        wildcards, but a  partial file name can be  used. For example, an
  486.        independent  file   entry  "ABC"  is   masking  "ABC",  "ABCDEF",
  487.        "ABC.DEF".   Another   example   is   when   using   a   door  to
  488.        extract/view/manipulate archives like DISP's MTS or Zipster, both
  489.        doors  create  temp.  files  which  should  be  inserted  in  the
  490.        Independent  Files  list.  In  MTS  (for  example)  it  should be
  491.        "DOWNLOA" (so it  will mask DOWNLOA*.* files), and  in Zipster is
  492.        should be "EXTRACT.ZIP".
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.         ┌──────────────────────────────────────────────────────────────┐
  505.         │░░░ MISSING FILES HANDLING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.2 ░░│
  506.         └──────────────────────────────────────────────────────────────┘
  507.  
  508.  
  509.  
  510.  
  511.  
  512.        I think I  should expand my  explanations about the  operation of
  513.        SMaster  in case  of missing   file in  both FILES.BBS  and DOS's
  514.        directories:
  515.  
  516.      ┌────────────┬────────────┬────────────────────────────────────────┐
  517.      │File exist  │File Exist  │  What will happen                      │
  518.      │On FILES.BBS│On directory│                                        │
  519.      ├────────────┼────────────┼────────────────────────────────────────┤
  520.      │   Yes      │   Yes      │  Normal operation. Nothing special.    │
  521.      ├────────────┼────────────┼────────────────────────────────────────┤
  522.      │   No       │   Yes      │  File will NOT BE LISTED in All-Files  │
  523.      │            │            │  or New-Files list, but on the         │
  524.      │            │            │  orphans-list, if created              │
  525.      ├────────────┼────────────┼────────────────────────────────────────┤
  526.      │   No       │   No       │  File will not be listed (no file!)    │
  527.      ├────────────┼────────────┼────────────────────────────────────────┤
  528.      │   Yes      │   No       │  File will be listed, but instead of   │
  529.      │            │            │  size/date, "OFFLINE" will be          │
  530.      │            │            │  written, as file is not available for │
  531.      │            │            │  download. If missing-files list is    │
  532.      │            │            │  created, file will be listed there.   │
  533.      └────────────┴────────────┴────────────────────────────────────────┘
  534.  
  535.  
  536.        And there is one more case:  File exist on both FILES.BBS and DOS
  537.        directory, but no description is assigned to it in the FILES.BBS.
  538.        In  this case,  SMaster will  put the  text you  specified in the
  539.        SMCFG as "No description text" field.
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.         ┌──────────────────────────────────────────────────────────────┐
  551.         │░░░ UPGRADING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.3 ░░│
  552.         └──────────────────────────────────────────────────────────────┘
  553.  
  554.  
  555.  
  556.  
  557.  
  558.         Upgrading  from  earlier  versions  of  SMaster  is very simple.
  559.         Complete all  operations as explained on  section 2.0. Then, you
  560.         will have to upgrade the config file to the current version. Run
  561.         CFGUP (no command line), and in a few milliseconds you will have
  562.         your configuration file ready to be used.
  563.  
  564.         Since  new versions  have fields  which do  not exist on earlier
  565.         versions, use SMCFG  to change the new fields  to your own needs
  566.         (since CFGUP uses default information  for a field not supported
  567.         in the early version).
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.         ┌──────────────────────────────────────────────────────────────┐
  579.         │░░░ REQUIREMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3.0 ░░│
  580.         └──────────────────────────────────────────────────────────────┘
  581.  
  582.  
  583.  
  584.  
  585.  
  586.         SMaster's requires:
  587.  
  588.           At LEAST 386Kb of free base memory.
  589.           MS-DOS 3.00 or higher.
  590.  
  591.         SMaster (and  all utility files around)  are using direct-screen
  592.         writes, for lightning-fast performance, yet do NOT cause snow on
  593.         old CGA screens, and do NOT "bleed" under DESQview.
  594.  
  595.         SMaster  was tested on 8088/6, V20, 80286, 386 and 486 machines.
  596.         It  was  tested under  QEMM-386 5.00 to 5.13, DESQview  2.26 to
  597.         2.34, 4DOS 3.03, NDOS 1.00 and MS-DOS 3.30 to 5.00.
  598.  
  599.         It has no fatal errors, so DESQview operation will go as usual
  600.         even if there are unexpected errors.
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.         ┌──────────────────────────────────────────────────────────────┐
  611.         │░░░ MULTI-LINE SYSTEMS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 4.0 ░░│
  612.         └──────────────────────────────────────────────────────────────┘
  613.  
  614.  
  615.  
  616.  
  617.  
  618.         When  running  under  MultiLine  BBSs,  things  are  tend  to be
  619.         complicated. Starting with version 3.00, SMaster is "officially"
  620.         MultiLine aware.
  621.  
  622.         When running a MultiLine BBS, there is the continuous danger  of
  623.         2 (or more) tasks  accessing  the  same file simultaneously. The
  624.         solution  for  this  is  using  SHARE.EXE  (a part of the MS-DOS
  625.         utilities), and using only  software which "knows" how  to treat
  626.         sharing and MultiLine BBSs.
  627.  
  628.         When SMaster opens files, it locks them, and does not let  other
  629.         tasks to use these files. In  that way, the files are safe,  and
  630.         you can be sure that users will not take part of the list (if it
  631.         is in the middle of being created, and user is downloading  it).
  632.         This is the case when dealing with all files, except  FILES.BBS.
  633.         When SMaster opens FILES.BBS, it allows other tasks to read  it,
  634.         but not to write  to it. In that  way, a user who  is OnLine can
  635.         view the file  list, but the  BBS software will  not be able  to
  636.         update FILES.BBS, not while SMaster reads it.
  637.  
  638.         When SMaster opens FILES.BBS for reading it, and find the  other
  639.         task is using the file right  now, and does not allow any  other
  640.         tasks to open it, it will retry to open the file up to 15 times,
  641.         with one  second delay  between each  try. If  it fails after 15
  642.         times, it  will skip  to the  next part  (next area  if listing,
  643.         abort sort if was in sort, will not display area-status if tried
  644.         to browse area etc).
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.         ┌──────────────────────────────────────────────────────────────┐
  656.         │░░░ TIPS AND TRICKS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 5.0 ░░│
  657.         └──────────────────────────────────────────────────────────────┘
  658.  
  659.  
  660.  
  661.  
  662.  
  663.        -  I strongly  recommend to run  SMaster manually, to  check that
  664.           everything  is going  smoothly, and  then include  it in  your
  665.           system-event  (if you  intend to  create the  lists on a daily
  666.           basis). Do not ever change anything without testing!
  667.  
  668.  
  669.        -  If  you  have  over  2000  Files,  or  you're using ANSI,  the
  670.           All-Files List may be huge. Compressing the list makes it much
  671.           smaller, making  the idea  of downloading  all-files list more
  672.           handy. If you do compress the list, a non-compressed file  (in
  673.           addition to the compressed one) can be useful.
  674.  
  675.  
  676.        -  If you enter description directly into FILES.BBS, don't  worry
  677.           about word-wrapping. BUT if the description should stay  AS-IS
  678.           (like when you draw boxes or any other ASCII shapes), keep its
  679.           length up to 45 Characters. Description that is longer than 45
  680.           Characters will be wrapped  (and if wrapping isn't  possible -
  681.           SMaster will cut it off).
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.         ┌──────────────────────────────────────────────────────────────┐
  693.         │░░░ MULTIPLE LISTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 5.0 ░░│
  694.         └──────────────────────────────────────────────────────────────┘
  695.  
  696.  
  697.  
  698.  
  699.  
  700.           If you  wish to create multiple  different lists, for example,
  701.           one All-Files list  with ANSI codes, and one  without, you can
  702.           use the new feature added  in SMaster v2.58 - multiple config.
  703.           files. You  should edit 2 DIFFERENT  configuration files using
  704.           SMCFG (for  example "SMCFG BBS1.CFG"  for first config.  file,
  705.           and "SMCFG BBS2.CFG" for second  config file). Then you should
  706.           run SMaster  twice, with the  "/C" command line  (for example,
  707.           "SMASTER  /CBBS1.CFG" for  creating first  list, and  "SMASTER
  708.           /CBBS2.CFG" for creating second list). You must make sure that
  709.           there  are no  identical file-names  in the  different config.
  710.           files.  If you  call the  MasterList in  the first config file
  711.           "ALLFILES.LST", and  use the same  name in the  second config.
  712.           file, SMaster will REWRITE the previous-created file.
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.         ┌──────────────────────────────────────────────────────────────┐
  724.         │░░░ REGISTERING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 6.0 ░░│
  725.         └──────────────────────────────────────────────────────────────┘
  726.  
  727.  
  728.  
  729.  
  730.  
  731.        SMaster  is not  free. You  may use  it for  31 days introduction
  732.        period, and  to decide if you  want to continue using  it. If you
  733.        do,  you have  to register  it, by  filling the registration form
  734.        (REGISTER.FRM, supplied with the package), and send it along with
  735.        check  or cash.  The amount  requested is  small, compared to the
  736.        time and  efforts  we  wasted  on  writing, debugging and testing
  737.        SMaster for over an year.
  738.  
  739.        After  sending  the  form,  you  will receive a registration key,
  740.        which matches your BBS  name, as  written in  the form.  You then
  741.        install it using SMREG (Self-explanatory, very user friendly). If
  742.        you followed all instructions correctly, SMREG will create a file
  743.        called SMASTER.REG. This file contains registration  information,
  744.        and will  cause SMaster  to know  you're registered,  and what is
  745.        your BBS name. This also  makes sure you will stay  registered on
  746.        all future versions.
  747.  
  748.  
  749.  
  750.         ┌──────────────────────────────────────────────────────────────┐
  751.         │░░░ T R A D E M A R K S ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 7.0 ░░│
  752.         └──────────────────────────────────────────────────────────────┘
  753.  
  754.         The following names are trademarks, registered trademarks,
  755.         copyrights and/or efforts of their authors (listed in an
  756.         alphabetical order):
  757.  
  758.  
  759.         4DOS                    J.P Software.
  760.         ANSI                    American National Standards Institute.
  761.         ARJ                     Robert K. Jung.
  762.         DESQview,
  763.         QEMM-386                Quarterdeck Systems.
  764.         LHA                     Haruyasu Yoshizaki.
  765.         MS-DOS                  Microsoft Corp.
  766.         MTS,
  767.         QFF,
  768.         QFV                     Robert W. Van Hoeven.
  769.         NDOS                    Symantec Corporation
  770.         PKZIP                   Phil Katz, PKWare.
  771.         QuickBBS                The QuickBBS Group.
  772.         RemoteAccess            Andrew Milner, Continental Software.
  773.         SuperBBS                Risto Virkkala & Aki Antman
  774.         ZipSter                 Bill Hay
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.         ┌──────────────────────────────────────────────────────────────┐
  786.         │░░░ LAST NOTES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 8.0 ░░│
  787.         └──────────────────────────────────────────────────────────────┘
  788.  
  789.  
  790.  
  791.  
  792.  
  793.        Before ending, I would like to  thank to all the people who  were
  794.        involved in some  way or another  in developing SMaster.  Special
  795.        thanks go to the  beta-testers, for testing, suggesting,  reading
  796.        and and and... So thanks, Saar Blitz and Roy Udassin!
  797.  
  798.        You can reach the beta-testers at:
  799.  
  800.  
  801.  
  802.        Saar Blitz - The Black Universe BBS, +972-3-9665202/9665257,
  803.                     24 Hours, 2400 MNP5, FidoNet 2:403/139.
  804.  
  805.        Roy Udassin - Triple D BBS, +972-8-476549, 24 Hours, 2400 MNP5,
  806.                      FidoNet 2:403/123.
  807.  
  808.  
  809.        This  is also  the place  to file-request  the latest  version of
  810.        SMaster, using the  magic name SMASTER.
  811.  
  812.  
  813.        Last  note,  which  applies  to  all  users, no matter if they're
  814.        registered  or  not.  Bug  Reports,  Comments  (MANY  COMMENTS!),
  815.        Suggestions and other stuff should go to the author:
  816.  
  817.  
  818.          SnailMail      Yossi Gottlieb,
  819.                         11 Armonim St.,
  820.                         Ramat-Gan 52587,
  821.                         Israel.
  822.  
  823.  
  824.          FidoNet        2:403/122.3 (or 2:403/122 should work either)
  825.  
  826.  
  827.          Voice Phone    +972-3-7519649
  828.  
  829.  
  830.                     And thanks for using SMaster ...
  831.  
  832.  
  833.